home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / COMM / LA31.ARJ / LA31.DOC next >
Text File  |  1992-04-21  |  13KB  |  291 lines
  1.          ┌──────────────────────────────────────────────────────────┐
  2.          │       LAPHONE v3.1     Written by Michael J. Baker       │
  3.          └──────────────────────────────────────────────────────────┘
  4.  
  5.                                  PURPOSE
  6.                                  -------
  7.  
  8. LAPHONE v3.1 is a nifty little utility that will calculate the assigned city
  9. of a phone number in the entire Pacific Bell service area.  This includes
  10. the entire 213, 818, 714, and 310 area codes, as well as the northern part of 
  11. the 619 area code, the southern part of the 805 area code, and a few 
  12. communities in the 602 area code (Arizona).  The program can also determine
  13. the type of phone call between a source and destination number (available to
  14. registered users only).  It is intended for people who make many calls
  15. within the Los Angeles area (such as computer users with modems), and are
  16. concerned about their phone bills.  Other features of this program include
  17. a city prefix search feature, and an area code prefix search feature.
  18.  
  19.                                                   
  20.                                    FILES
  21.                                    -----
  22.  
  23. The files included with this program are:
  24.  
  25.                     LA31.EXE    (The program)
  26.                     LA31.DOC    (This file)
  27.                     LAPHONE.DAT    (Prefix data file)
  28.                     LACITY.DAT     (City data file)
  29.                     REGISTER.DOC   (Please read!  Registration info)
  30.                     LA31.NEW    (Update list)
  31.  
  32. LAPHONE.DAT and LACITY.DAT MUST be in the same directory as LAPHONE.EXE for
  33. the program to work.  This program may be freely distributed, provided that
  34. all the above files (in their unaltered form) are included, and that no
  35. charge is collected for doing so.  In order to use the program, YOU MUST
  36. REGISTER!
  37.  
  38.                                   
  39.                                    FORMAT
  40.                                    ------
  41.  
  42. You can use the program from the command line or with the menu interface.
  43.  
  44.  
  45. Command line
  46. ------------
  47.  
  48. la31 [argument 1] [argument 2 (optional)] ........ [argument n (optional)]
  49.  
  50. Argument = a telephone prefix,
  51.            area code and a prefix,
  52.            normal 7 digit number,
  53.            area code + 7 digit number,
  54.            a city name
  55.            or an area code
  56.                  
  57. You may process as many arguments as DOS will allow you to type on the command
  58. line. 
  59.     A new menu driven interface has been added in version 3, which activates
  60. itself when no command line arguments have been entered:
  61.  
  62.  
  63. Menu interface
  64. --------------
  65.               
  66.               ╔════════════════════════════════════════════╗  
  67.               ║  LAPHONE v3.1  Written by Michael J. Baker ║
  68.               ║                                            ║
  69.               ║          1) Search a phone number          ║
  70.               ║          2) Search an area code            ║
  71.               ║          3) Search for city prefixes       ║
  72.               ║          4) Change colors                  ║
  73.               ║          5) Change text mode               ║
  74.               ║          6) List LAPHONE cities            ║
  75.               ║          7) Edit prefix codes              ║
  76.               ║          8) PLEASE REGISTER!               ║
  77.               ║          9) Exit to DOS                    ║
  78.               ║                                            ║
  79.               ╚════════════════════════════════════════════╝
  80.  
  81. The menu interface has extra options that cannot be accessed from the command
  82. line.  These are 'Changing colors', 'Changing text mode', 'List LAPHONE
  83. cities', and 'Edit prefix codes'.  The registered version of the program has 
  84. no 'PLEASE REGISTER!' choice, for obvious reasons.
  85.  
  86.                                   
  87.                                   REMARKS
  88.                                   -------
  89.  
  90. The telephone number(s) can be entered in one of four formats:
  91.  
  92.                     XXX             (Prefix only)
  93.                     XXX-XXXX        (Prefix and Suffix)
  94.                     XXX-XXX         (Area code and Prefix)
  95.                     XXX-XXX-XXXX    (Full number)
  96.  
  97. The suffix need not be entered, but doing so will not mess up the program.
  98. When entering a number that is not prefix only, the "-" must be included.
  99. Notice that the area code is optional, but leaving it out will cause the
  100. program to search ALL area codes for the desired number, and will display
  101. all hits.  If two or more numbers are entered, their formats can be mixed up
  102. with no problem.  For example, the first number can be of format XXX, the
  103. second XXX-XXX, the third XXX-XXX-XXXX, etc.  If you attempt to enter a
  104. number of another format, an error message will be displayed.  When one
  105. number is entered, the community to which the number is assigned will be
  106. displayed.  Registered users will be able to determine the type of call
  107. between their home town and any other city.  The cost of the call between
  108. the two will then be known.  See the EXAMPLES section below to see how this is
  109. done.  The distribution version has VAN NUYS as the home town (I used to live 
  110. there), so you can see how the program works.  If you live in VAN NUYS, you 
  111. are lucky, but you should still register.  There are 4 types of calls:
  112.  
  113.                     LOCAL or ZONE 1 (0-12 miles away)
  114.                     ZONE 2 (13-16 miles away)
  115.                     TOLL or ZONE 3 (>16 miles in select cities)
  116.                     LONG DISTANCE (>16 miles in most cities)
  117.  
  118. The cost of each call (as of November 1, 1991) is:
  119.  
  120.                     LOCAL or ZONE 1 = FREE
  121.                     ZONE 2 = $.10 for the first minute, $.04 each 
  122.                              additional minute, may vary slightly in 
  123.                              different areas
  124.                     TOLL or ZONE 3 = $.17 to $.25 for the first minute, 
  125.                                      $.07 to $.16 each additional minute, 
  126.                                      may vary slightly in different areas
  127.                     LONG DISTANCE = NOT CALCULATED BY THIS PROGRAM   
  128.                                     
  129. Note: A discount of 30% applies to calls placed from 5-11pm and a 60%
  130. discount from 11pm-8am, weekends, and certain holidays IN ALL ZONES.  The
  131. rates shown above are the MAXIMUM rates you would have to pay.  The rates
  132. above were those in effect on November 1, 1991, and are subject to change.
  133. Future updates of this program will incorporate these changes.
  134.  
  135.      Other features of this program include color changing, a city prefix 
  136. search feature, an area code prefix search feature, and a prefix code editor.  
  137.      
  138. Changing colors     
  139. ---------------
  140.      
  141.      To change the program colors, choose option '4)' from the program menu.  
  142. You can then modify the program's foreground, background, and highlight 
  143. colors, using the arrow keys.  This should be self-explainatory (I hope).  
  144.      
  145.  
  146. City prefix search     
  147. ------------------
  148.  
  149.      Typing a city name as one of the arguments (or choosing option '3)' from 
  150. the program menu) will begin a search for ALL prefixes assigned to that city.  
  151. All cities with two or more words must be separated by the '_' symbol on the 
  152. command line (as in van_nuys and los_angeles_12).  This is necessary because 
  153. the program uses spaces to separate command arguments.  This is NOT necessary 
  154. from the program menu.  
  155.      
  156.      If you are unsure of the spelling of a city, or what cities are 
  157. acceptable to search, try choosing '6)' from the program menu, and all of the 
  158. cities known to LAPHONE will be listed.  If you cannot find your city in this
  159. list, don't worry, PACIFIC BELL sometimes considers one city as part of 
  160. another city for organizational purposes.  For example, Sherman Oaks is 
  161. considered to be part of VAN NUYS.  
  162.  
  163.  
  164. Area code prefix search
  165. -----------------------
  166.  
  167.      Typing an area code (choice '2)' from the program menu or on the command 
  168. line) displays ALL the prefixes in that area code, with appropriate 
  169. assignments.  All prefixes from 201-999 will be displayed (there are no 
  170. prefixes below 201).  This is a long list, the screen will pause automatically
  171. after each screenfull of information.
  172.  
  173.  
  174. Prefix editor
  175. -------------
  176.      
  177.      Since keeping up with prefix code changes is a daunting task that tends
  178. to drive me insane, I have included a prefix editor for version 3.1.  This 
  179. will allow you to change the assignment of a particular prefix yourself,
  180. instead of waiting for the next release to come out.  
  181.      To edit a prefix code, choose '7)' from the program menu.  You will be
  182. asked the area code and prefix whose assignment needs to be changed.  The
  183. program will then tell you the current assignment (either a city name or 
  184. 'UNASSIGNED' if there is none).  You then type in the new assignment (or ENTER
  185. if you wish to make no change).  Make sure you know the spelling of the city
  186. you are typing in, choose '6)' from the program menu if you are unsure.  If 
  187. the city you type in is not part of LACITY.DAT (which has all the cities
  188. known to LAPHONE), an error message will be displayed.  After successfuly
  189. typing in the new assignment, the new information will be saved (in 
  190. LAPHONE.DAT).
  191.  
  192.  
  193.                                   
  194.                                   EXAMPLES
  195.                                   --------
  196.  
  197. 1)  'la31 787'
  198.  
  199.      will result in
  200.  
  201. 'The prefix 787 is assigned to VAN NUYS in the 818 area code (LOCAL)'
  202. 'The prefix 787 is UNASSIGNED in the 213 area code'
  203. 'The prefix 787 is assigned to RIVERSIDE in the 714 area code (LD)'
  204. 'The prefix 787 is UNASSIGNED in the 619 area code'
  205. 'The prefix 787 is UNASSIGNED in the 805 area code'
  206. 'The prefix 787 is UNASSIGNED in the 602 area code'
  207. 'The prefix 787 is assigned to TORRANCE in the 310 area code (LD)'
  208.  
  209. The type of call appears at the end of the line.  In other words, a call
  210. from VAN NUYS (the home town in the distribution version) to TORRANCE is
  211. LONG DISTANCE.  Note that since the area code was not specified with the
  212. prefix, ALL area codes were searched.
  213.  
  214.  
  215. 2)  'la31 352-0697'
  216.  
  217.      will result in
  218.  
  219. 'The number 352-0697 is assigned to SUNLAND-TUJUNGA in the 818 area code (LOCAL)
  220. 'The number 352-0697 is UNASSIGNED in the 213 area code'
  221. 'The number 352-0697 is assigned to ARLINGTON in the 714 area code (LD)'
  222. 'The number 352-0697 is UNASSIGNED in the 619 area code'
  223. 'The number 352-0697 is UNASSIGNED in the 805 area code'
  224. 'The number 352-0697 is UNASSIGNED in the 602 area code'
  225. 'The number 352-0697 is assigned to GARDENA in the 310 area code (LD)'
  226.  
  227. Since a full number was entered, it says 'The number' instead of 'The
  228. prefix'.
  229.  
  230.  
  231. 3)  'la31 818-352'
  232.  
  233.      will result in
  234.  
  235. 'The prefix 352 is assigned to SUNLAND-TUJUNGA in the 818 area code (LOCAL)'
  236.  
  237. In this example, the area code is specified, so only one hit is found.
  238.  
  239.  
  240. 4) 'la31 culver_city'
  241.  
  242.    will result in
  243.  
  244. 'CULVER CITY (310 area code) (LOCAL)'
  245. '----------------------------------'
  246.  
  247. '202 204 280 287 558 559 836 837 838 839 840 841 842'
  248.  
  249. This is a typical city prefix search.  The numbers represent ALL of the 
  250. prefixes assigned to CULVER CITY.  The area code is specified after the city
  251. name.  Also, the type of call is specified, in this case a call to CULVER
  252. CITY from VAN NUYS is a LOCAL call.
  253.  
  254.  
  255. 5) 'la31 310'
  256.  
  257.     will result in
  258.  
  259. 'AREA CODE 310'
  260. '-------------'
  261.  
  262. '201-BEVERLY HILLS       202-CULVER CITY          203-BEVERLY HILLS'
  263. '204-CULVER CITY         205-BEVERLY HILLS        206-WEST LOS ANGELES'
  264. '207-WEST LOS ANGELES    208-WEST LOS ANGELES     209-WEST LOS ANGELES'
  265.                                    .
  266.                                    .
  267.                                    .
  268.                                    .
  269.  
  270. A typical area code prefix search is shown here.  All prefixes from 201-999
  271. will be displayed (there are no prefixes below 201).  This is a long list, the
  272. screen will pause after each screenfull of information.
  273.  
  274.  
  275.  
  276. This program is based on the Pacific Bell White Pages, good through May 1992.  
  277. However, changes in zoning or cost of calls are possible before then.  These 
  278. will be corrected in later versions.  If there are any errors in the 
  279. assignment of phone numbers or any other bugs in this program (I had to type 
  280. over 4,800 prefix codes in this program, so there are bound to be a few!!),  
  281. please write me at the address below and let me know.  I will correct it in a 
  282. later version.  Since there may be bugs, and since the phone company changes
  283. rates and prefix codes on a regular basis (difficult to keep up with), you use
  284. this program AT YOUR OWN RISK.  I can take NO RESPONSIBILITY for the results
  285. of this program.
  286.  
  287. HAVE FUN!!!!!!!!!!!
  288.  
  289.  
  290.  
  291.